home *** CD-ROM | disk | FTP | other *** search
/ Shareware Grab Bag / Shareware Grab Bag.iso / 081 / mailchek.arc / MAILCHEK.DOC < prev    next >
Text File  |  1987-06-27  |  37KB  |  1,123 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.  
  17.  
  18.  
  19.  
  20.  
  21.  
  22.  
  23.  
  24.                                   MailChek
  25.                        Version 2.06 .. 22nd June 1987
  26.  
  27.                                       By
  28.                                   Marc Ache'
  29.  
  30.                                Documentation By
  31.                                   Mike Janke
  32.  
  33.                       CompuSci OPUS 135/8 in the Matrix
  34.                                 (305)758-4821
  35.  
  36.  
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.  
  51.  
  52.  
  53.  
  54.  
  55.  
  56.  
  57.  
  58.  
  59.  
  60.  
  61.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  62.  
  63.  
  64.  
  65.  
  66.  
  67.                                                                 Page 1
  68.  
  69.  
  70.  
  71.  
  72.                             TABLE OF CONTENTS
  73.                             _________________
  74.  
  75.          Topic                                                 Page
  76.          -----                                                 ----
  77.  
  78.       Introduction.............................................. 2
  79.  
  80.       Files in the ARChive...................................... 2
  81.  
  82.       MailChek Commands......................................... 2
  83.  
  84.       The Control File (MailChek.cnf)........................... 4
  85.  
  86.       Installation/putting it all together...................... 9
  87.  
  88.       Notes.....................................................11
  89.  
  90.       Registration..............................................14
  91.  
  92.       In Closing................................................15
  93.  
  94.       Revision History..........................................16
  95.  
  96.  
  97.  
  98.  
  99.  
  100.  
  101.  
  102.  
  103.  
  104.  
  105.  
  106.  
  107.  
  108.  
  109.  
  110.  
  111.  
  112.  
  113.  
  114.  
  115.  
  116.  
  117.  
  118.  
  119.  
  120.  
  121.  
  122.  
  123.  
  124.  
  125.  
  126.  
  127.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  128.  
  129.  
  130.  
  131.  
  132.  
  133.                                                                 Page 2
  134.  
  135.  
  136.                               INTRODUCTION
  137.  
  138.       MailChek blossomed  from one OPUS  SysOp's dream  to have a real
  139.       time mail checking  system.   MailChek is just that.   Each time
  140.       a user logs on,  he/she will receive an up to the minute list of
  141.       all mail waiting.  This mail waiting list is for that particular
  142.       user only, and it's  not at all like  "MESSage WAITing" programs
  143.       use on Other(tm) systems.
  144.  
  145.       In addition, there are many features  that  will  make a  sysops
  146.       life easier.   These include  the ability  to forward  specified
  147.       users mail into  the Netmail  area, using aliases,  and a  handy
  148.       built in message  editor.   The editor is just a plus,  and does
  149.       not come into use for the actual MailCheking procedure.
  150.  
  151.  
  152.                              MAILCHEK.ARC
  153.  
  154.       The  MailChek  archive  you've  downloaded  should  contain  the
  155.       following files.
  156.  
  157.       MAILCHEK.EXE          ;The main program
  158.       MAILS1-3.EXE          ;Performs the search for mail
  159.       MAILCHEK.DOC          ;What you're reading now
  160.       MAILCHEK.CNF          ;The MailChek control file
  161.       WELCOME.BBS/GBS       ;Sample file to execute MailChek
  162.       WELCOME2.BBS/GBS      ;another sample file
  163.       RUNOPUS.BAT           ;Yet another sample file
  164.  
  165.  
  166.       NOTE: MAILCHEK.EXE, MAILS1-3.EXE and MAILCHEK.CNF must reside in
  167.             your OPUS directory.
  168.  
  169.  
  170.  
  171.                            MailChek Commmands
  172.  
  173.  
  174.  
  175.       MAILS1-3.EXE - MAILS1-3.EXE is a standalone program that is used
  176.                      in conjunction with MAILCHEK.EXE. MAILS1-3 is run
  177.                      from  within  WELCOME.BBS/GBS  and  performs  the
  178.                      actual  search  for  waiting mail.   There are no
  179.                      command  line  options.  Use of  MAILS1-3.EXE  is
  180.                      described  in greater detail later on in this doc
  181.                      file.
  182.  
  183.  
  184.       MAILCHEK <command>
  185.  
  186.  
  187.  
  188.       Commands: Compile, Update and Editor
  189.  
  190.  
  191.  
  192.  
  193.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  194.  
  195.  
  196.  
  197.  
  198.  
  199.                                                                 Page 3
  200.  
  201.  
  202.       COMPILE:  Compile is used to set your MailChek system up for the
  203.                 first  time.   It is  also necessary  to run  MAILCHEK
  204.                 COMPILE if you RENUM your message  areas or change any
  205.                 options in the MAILCHEK.CNF file.  This command can be
  206.                 run manually or through a batch file if needed (if for
  207.                 example,  you RENUM through a batch file ).   You will
  208.                 also have to run MAILCHEK COMPILE if you kill messages
  209.                 that are not TO:  or FROM:  you.  It is suggested that 
  210.                 you  run  MAILCHEK COMPILE each morning after  all  of 
  211.                 your external events.
  212.  
  213.  
  214.       UPDATE:  "MailChek Update" is run after each user logs off.  You
  215.                 will have to  set up  the OPUS  control  file to  exit
  216.                 after each caller.   See the OPUS docs for the details
  217.                 on how you perform this task.  When OPUS exits with an
  218.                 errorlevel, your RUNOPUS.BAT (or whatever you call it)
  219.                 should execute MAILCHEK UPDATE and return to run OPUS.
  220.                 See  the example RUNOPUS.BAT included.   This updating
  221.                 after  each caller  is what  makes this a  "Real Time"
  222.                 mail checking program.  MAILCHEK UPDATE will update or
  223.                 recompile  the individual  message areas as necessary.
  224.                 This  occurs  at  lightning  fast  (well, lets not get
  225.                 carried away,  but it  is quick) speed  so  that  your
  226.                 system  is  ready  for  the next  caller in  the least
  227.                 amount of time.  
  228.  
  229.  
  230.       EDITOR:   Typing  "MailChek Editor"  will call  up the  built in
  231.                 message editor.  The editor is NOT used in any way for
  232.                 the MailChek procedure.   This is  just a little extra.
  233.                 When MAILCHEK EDITOR is executed from DOS,  you will be
  234.                 be in your first message area (this will most likely be
  235.                 area 0).  The  first  message header  will be displayed
  236.                 along  with  information  concerning  the low  and high
  237.                 message numbers, the type of message area (LOCAL, ECHO,
  238.                 MATRIX) and message attributes. The body of the message
  239.                 will be displayed only if you request it with the V)iew
  240.                 command.  Message  attribute bits may be toggled ON/OFF
  241.                 with a simple one key command.  All commands are listed
  242.                 on the  bottom  half of the  screen and are replaced by
  243.                 the body of the message when requested.   Note that you
  244.                 cannot  edit the  body of the  message  or R)eply.  The
  245.                 editor can only alter the  header and  attributes.  Use
  246.                 'Q' to quit the editor.
  247.  
  248.  
  249.  
  250.  
  251.  
  252.  
  253.  
  254.  
  255.  
  256.  
  257.  
  258.  
  259.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  260.  
  261.  
  262.  
  263.  
  264.  
  265.                                                                 Page 4
  266.  
  267.  
  268.                     THE MailChek CONTROL FILE (MAILCHEK.CNF)
  269.  
  270.  
  271.       As with OPUS,  MailChek  uses a  control  file to set up  all the
  272.       possible options.  Following is a  description of each  option in
  273.       the order it appears in the MAILCHEK.CNF  control file. Note that
  274.       MailChek has no limit for many of the options.  You may designate
  275.       as many message areas to check as OPUS  will  allow.  If you have
  276.       600 users, no problem.  4000 messages?  No problem.
  277.  
  278.  
  279.       Control File Options:
  280.  
  281.       AREAS #,#,##,##
  282.  
  283.                These are the areas  you want  MailChek to  maintain  in
  284.                in the waiting mail list.  You may include every  single
  285.                area on your system,  or you may just want to make  sure
  286.                users are aware of mail waiting  for them in the private
  287.                mail area.
  288.  
  289.                Note: No matter what  order you  place the areas numbers
  290.                      in, your NetMail area will always be compiled last
  291.  
  292.  
  293.       USER c:\path\path\user.bbs
  294.  
  295.                This  tells  MailChek the name of your user  file.  Your
  296.                user file is used so MailChek won't bother with messages
  297.                to ALL, ANYONE or other names that  do not  exist.  Your
  298.                user file is only read,  and is not modified in any way.
  299.  
  300.       LINK  c:\path\path\filename  (use no extension)
  301.  
  302.               Tell MailChek what to display after it displays the users
  303.               mail waiting (or "sorry, no mail" as the case may be).  I
  304.               would suggest a ^A as the first line of this linked  file
  305.               to prevent the users mail  list from disappearing  before
  306.               he/she can absorb all the info!  Since OPUS is doing  the
  307.               the actual displaying of the file, the appropriate BBS or
  308.               GBS file will be used according to the user ANSI setting.
  309.  
  310.       MAIL  c:\path\path\filename  (use no extension)
  311.  
  312.              Allows use of BBS or GBS  file as per  users ANSI Setting.
  313.              Name of file to display if  user has mail  waiting.  If no
  314.              file  is  specified,  the message  "You have mail waiting"
  315.              will be displayed.
  316.  
  317.  
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  326.  
  327.  
  328.  
  329.  
  330.  
  331.                                                                 Page 5
  332.  
  333.  
  334.       NOMAIL c:\path\path\filename  (use no extension)
  335.  
  336.              Name of a  file to  display  if user  has no mail waiting.
  337.              Allows use of  BBS/GBS  file  as per  users  ANSI setting.
  338.              Allows you to say something like "You gotta  post some  to
  339.              get some" or whatever. If you comment this out the default
  340.              message "Sorry, no mail today" is displayed.
  341.  
  342.  
  343.       RMSGS or
  344.       RMSGS NODISPLAY 0 or
  345.       RMSGS NODISPLAY 1
  346.  
  347.              Using "RMSGS" will cause received  messages to be included
  348.              in the list of messages  waiting.   If  you don't  want to
  349.              have received  messages  included,  then append  NODISPLAY
  350.              on to the RMSGS  command line.   If you  use the NODISPLAY
  351.              option  you  may  specify  whether  or  not  you want  the
  352.              message,  "NOTE: Received  messages  not  included. . . ."
  353.              displayed.  A  0 (zero) following  NODISPLAY means display
  354.              this message and a 1 means supress it. Do not use the 0 or
  355.              1 if you do not use the NODISPLAY option.
  356.  
  357.  
  358.       COPYRIGHT DISPLAY
  359.  
  360.              Commenting this line out suppresses  the Copyright notice.
  361.  
  362.  
  363.  
  364.       FORMAT [ 1 - 3 ]
  365.  
  366.              If a user has mail  waiting,  this  number  will determine
  367.              how the message  areas/numbers are displayed. MAILS1-3.EXE
  368.              supports  formats 1  through 3.  Future  formats  would be
  369.              reflected in the filename  numbers in the  release  of the
  370.              MAILS#-#.EXE program.
  371.  
  372.              Here's how formats 1 - 3 will appear.
  373.  
  374.  
  375.       FORMAT 1  Displays...
  376.  
  377.                  Msg Area 1: 1, 2p, 3r   ; example area number
  378.                                          ; 'p' indicates private msg
  379.                                          ; 'r' for received if enabled
  380.  
  381.       FORMAT 2  Displays...
  382.  
  383.                  Msg Area 1: Private Email           ; area name
  384.                              1p, 2r, 3pr, 4          ; message numbers
  385.  
  386.  
  387.  
  388.  
  389.  
  390.  
  391.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  392.  
  393.  
  394.  
  395.  
  396.  
  397.                                                                 Page 6
  398.  
  399.  
  400.       FORMAT 3  Displays...
  401.  
  402.                  Msg Area 1: "Private Email"             ; area name
  403.                              Message Number(s): 1,2,3    ; msg numbers
  404.  
  405.                  Note: The "p" and "r" indicators  are  not  shown with
  406.                        FORMAT 3.
  407.  
  408.  
  409.       COLORS #,#...#,#
  410.  
  411.  
  412.              MailChek has the ability to use ansi colors and attributes
  413.              to create various built in titles and labels, plus set the
  414.              colors of message numbers, commas, and area number. Rather
  415.              than carve  these  colors  in  stone,  you are  given  the
  416.              ability  to set  what colors/attributes  you want for each 
  417.              item.   Note that if you use the color command, you *MUST*
  418.              have an attribute & color  set for each  item even if that
  419.              item will not display. In other words, if you use FORMAT 1
  420.              #,stitle will not be used  in the  display,  but it  still
  421.              must be included in the COLOR command line. If you comment
  422.              out the COLOR line in the MailChek.cnf file, MailChek will
  423.              assume you do not want ANSI.  Using the COLOR  option will
  424.              not force ANSI on users  that  don't  want it.  Since OPUS
  425.              does the actual displaying of the files,  the  appropriate
  426.              BBS/GBS file will be displayed.  MailChek will create both
  427.              a BBS and GBS file and let OPUS take it from there.
  428.  
  429.              If you do want ANSI used, the following applies.
  430.  
  431.       COLORS #,nhead #,num1 #,num2 #,comma #,title #,stitle #,general
  432.  
  433.              Each of the above consist of two integers  separated  by a
  434.              comma (eg. 1,34)
  435.  
  436.              The  first number  is the color  attribute, and the second
  437.              number stands for the color  you  want for  the  following
  438.              sections of the mail waiting display...
  439.  
  440.               NHEAD   : "Msg area"
  441.               NUM1    : The number of the message area
  442.               NUM2    : The number(s) of the message(s)
  443.               COMMA   : "," (color of the comma separating msg #'s)
  444.               TITLE   : The message area title
  445.               STITLE  : "Message number(s)" in FORMAT 3
  446.               GENERAL : The default displays (eg."You have mail..")
  447.  
  448.  
  449.  
  450.  
  451.  
  452.  
  453.  
  454.  
  455.  
  456.  
  457.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  458.  
  459.  
  460.  
  461.  
  462.  
  463.                                                                 Page 7
  464.  
  465.  
  466.       The colors available are..
  467.  
  468.               FOREGROUND               BACKGROUND
  469.               ----------               ----------
  470.  
  471.                30 Black                40
  472.                31 Red                  41      Same Colors
  473.                32 Green                42      except background
  474.                33 Yellow               43
  475.                34 Blue                 44
  476.                35 Magenta              45
  477.                36 Cyan                 46
  478.                37 White                47
  479.  
  480.  
  481.       And available attributes are...
  482.  
  483.                0 = Normal
  484.                1 = Bold On (hi intensity)
  485.                5 = Blink
  486.                7 = Reverse
  487.  
  488.  
  489.       So...
  490.  
  491.       COLORS 0,34 0,35 0,35 0,36 1,37 1,34 0,33
  492.  
  493.           Would display
  494.  
  495.          "Msg area" as normal intensity blue ................... (0,34)
  496.           Msg Area numbers in normal intensity magenta ......... (0,35)
  497.           Message numbers in normal intensity magenta .......... (0,35)
  498.           The comma between msg #'s in normal intensity cyan ... (0,36)
  499.           Message area title in hi intensity white.............. (1,37)
  500.          "Message Number(s)" in hi intensity Blue............... (1,34)
  501.           Default displays in normal intensity yellow........... (0,33)
  502.  
  503.  
  504.  
  505.       ALIAS name1,name2
  506.  
  507.              Name2 will be notified of mail waiting for Name1. MailChek
  508.              changes name1 to name2  in the  message  header.   This is
  509.              very useful if your users  consistently  post  messages to
  510.              you using a different variation of your name.   My name on
  511.              my system is MIKE,  but many  users  post messages to MIKE
  512.              JANKE.   ALIAS corrects this.   You may  use any number of
  513.              ALIASes.
  514.  
  515.              Example: ALIAS Mike Janke,Mike
  516.                       ALIAS Sysop,Mike
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  524.  
  525.  
  526.  
  527.  
  528.  
  529.                                                                 Page 8
  530.  
  531.  
  532.       ALERT name1,name2
  533.  
  534.              This command is similiar to the ALIAS command shown  above
  535.              above.  The options are the same, but in ALERT, name1 will
  536.              be notified of mail waiting for name2.   This is the exact
  537.              opposite of how ALIAS works.  The other difference is that
  538.              ALERT will NOT physically change the name  in the  message
  539.              header as ALIAS does.
  540.  
  541.       GENERAL name1,name2
  542.  
  543.              Want to make sure your users read a specific  message?  If
  544.              your name is name1,  then any  message you  post  to name2
  545.              will be placed in EVERY  users  mail  waiting list.  Since
  546.              there is  no way to tell  if a user has read this message,
  547.              it will be  listed as  a waiting  message  for every user,
  548.              every  time they  log on,  until this  message is  deleted 
  549.              and you run MAILCHEK COMPILE. You may have any  number of   
  550.              GENERAL name1,name2 lines in the control file.
  551.  
  552.              Example: GENERAL Mike,All Kendall Users
  553.  
  554.  
  555.       NETMAIL name,net/node,priority,move(or copy)
  556.  
  557.              If a  user  posts  a message  to the  person specified  by
  558.              "name"  in the NETMAIL command line, that message  will be
  559.              put  in your  netmail  area  when the  user  logs  off and
  560.              MAILCHEK UPDATE is executed. The message will then be sent
  561.              to the net/node specified  during  your  next mail  event.
  562.              Whether it is moved (original deleted) or copied (original
  563.              message remains)  depends  on  the  setting  of  the  last
  564.              last command line option.   This command  is  particularly
  565.              handy for making sure that SysOps within your  net are  up
  566.              to the minute on  messages  posted to them on your System.
  567.  
  568.              The first two options, NAME and NET/NODE are pretty  self-
  569.              explanatory.   A message  posted to  NAME  will  be  moved
  570.              (or copied) to the  netmail area  and  address it   with a
  571.              destination of NET/NODE. PRIORITY is either CRASH or NONE.
  572.              CRASH only applies if you run a SEAdog system or OPUS 1.xx
  573.              If you do not wish the message to be sent  CRASH  priority 
  574.              or you do not run a system capable of CRASH mail, then set
  575.              priority to  NONE.  The  last  option  determines how  the
  576.              message is  moved.  If  you set  the last  option to MOVE,
  577.              the message  will be  moved to  the netmail  area, and the
  578.              original message  will be  deleted  from the  area  it was
  579.              posted.  If  the last  option is set  to NONE, the message
  580.              will be copied to the  netmail area,  the original will be
  581.              left in the area it was  posted,  and a  notice  ("Message
  582.              Forwarded...") will be appended to the message.
  583.  
  584.              Example: NETMAIL Marc Ache',135/8,CRASH,MOVE
  585.  
  586.              Note: EchoMail messages will not be forwarded by NETMAIL.
  587.  
  588.  
  589.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  590.  
  591.  
  592.  
  593.  
  594.  
  595.                                                                 Page 9
  596.  
  597.  
  598.                            PUTTING IT ALL TOGETHER
  599.                            -----------------------
  600.  
  601.  
  602.       Installing  MAILCHEK is really quite  simple.  You  could  almost
  603.       skip  the  docs and  install it by looking at the enclosed sample
  604.       files  and by reading the commented MAILCHEK.CNF file.  There are
  605.       a couple important points you may have missed if you jumped right
  606.       to this  point in  the  documentation,  and  I'll  outline  those
  607.       necessary changes to your OPUS system.
  608.  
  609.       The  first  step  is  to  place  MAILCHEK.EXE,  MAILS1-3.EXE  and
  610.       MAILCHEK.CNF in your OPUS directory. MAICHEK.CNF is needed during
  611.       COMPILE, but is not used with the other options.
  612.  
  613.       Edit the MAILCHEK.CNF file to fit your requirements. Don't forget
  614.       to set the paths for the for the external files it uses.
  615.  
  616.       Create custom  YOUMAIL.BBS/GBS and  NOMAIL.BBS/GBS  if you do not
  617.       wish  to use  the  default  displays.  If  you have ANSI graphics
  618.       enabled, MAILCHEK  will first look for the .GBS file (if the user
  619.       has ANSI on).  If not found, it  will  next look for a .BBS file,
  620.       and  if  that  is  not there  it will  use the  default, built in
  621.       messages.
  622.  
  623.       Edit  the OPUS.CTL file so that OPUS exits after each caller with
  624.       an  errorlevel set.  See  the  OPUS docs for information on this.
  625.       Don't  forget  to recompile  OPUS.CTL  with the compiler supplied
  626.       with OPUS.
  627.  
  628.       Edit your  RUNOPUS.BAT  (or whatever  you call the batch file that
  629.       runs  your  opus  system)  so that  it  executes  MAILCHEK  UPDATE
  630.       everytime  OPUS  exits with  the errorlevel you have set.  See the
  631.       enclosed sample RUNOPUS.BAT file.
  632.  
  633.  
  634.       Edit, modify, or  create your  own WELCOME.BBS/GBS files using the
  635.       enclosed sample as a guide.  You  could, for  example, perform the
  636.       MailChek from a bulletin option rather than doing so automatically
  637.       when a caller first logs on.  In  that  case,  name  the  enclosed
  638.       WELCOME.BBS/GBS files a name to your liking and call it from  your
  639.       bulletin menu.
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651.  
  652.  
  653.  
  654.  
  655.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  656.  
  657.  
  658.  
  659.  
  660.  
  661.                                                                 Page 10
  662.  
  663.  
  664.       Here's what the sample WELCOME.BBS file looks like  and what  each
  665.       line does...
  666.  
  667.                            SAMPLE WELCOME.BBS FILE
  668.                           --------------------------
  669.  
  670.  
  671.  Looking in your mail box ......   ; just  a   message  to  the  user
  672.  ^OOMAILCHEK.DAT                   ; open  a file called MailChek.dat
  673.  ^OP                               ; Place users name in MailChek.dat
  674.  ^OODUMMY                          ; Force OPUS to close MailChek.dat
  675.  ^OCmails1-3                       ; Run MAILS1-3.EXE - This performs
  676.                                    ; the  search for mail and creates
  677.                                    ; the  file  MAILCHEK.BBS/GBS  for
  678.                                    ; later display.
  679.  ^B^L                              ; prevent ^C and clear the screen
  680.  
  681.  
  682.  
  683.    ^F^D  <-- Display the Date          Display the time -->  ^F^T
  684.  
  685.  
  686.  
  687.  You are our ^F^Q call to this system  ; Just some extra info. Modify
  688.                                        ; as you like.
  689.  
  690.  ^OSmailchek                       ; Display the  file  MAILCHEK.BBS/GBS
  691.                                    ; These files are created by MAILS1-3
  692.                                    ; and change with each user. MAILCHEK
  693.                                    ; Then displays  the  file  specified
  694.                                    ; in  MAILCHEK.CNF  file  by the LINK
  695.                                    ; option
  696.  
  697.  
  698.  - END OF SAMPLE WELCOME.BBS/GBS
  699.  
  700.       NOTE: As of v0.00, OPUS will NOT return to the file that used ^OS
  701.             to display a file.  This is the whole purpose of  supplying
  702.             a LINK command in the control file.  Putting anything after
  703.             after '^OSmailchek' in the above sample welcome  file  will
  704.             do nothing.  In most cases, if no LINK  file is  specified,
  705.             the users waiting mail will be displayed  and it will  drop
  706.             immediately into your  bulletin, or the  main  menu if  you
  707.             have no bulletin.  Also remember that  even though  nothing
  708.             is put into the DUMMY file, this file  will still  continue
  709.             to grow with each log on.  It will take some time before it
  710.             gets to be a waste of space, but it's something you  should
  711.             delete occasionally.
  712.  
  713.  
  714.  
  715.  
  716.  
  717.  
  718.  
  719.  
  720.  
  721.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  722.  
  723.  
  724.  
  725.  
  726.  
  727.                                                                 Page 11
  728.  
  729.  
  730.                                    NOW WHAT!
  731.  
  732.       Ok, you've created all the necessary  text/ansi files and put all
  733.       the MAILCHEK files (MAILCHEK.EXE,  MAILS1-3.EXE and MAILCHEK.CNF)
  734.       in your OPUS subdirectory.
  735.  
  736.       While in the subdir containing the MAILCHEK files, Type "MAILCHEK
  737.       COMPILE" and press ENTER (use no quotes of course!).
  738.  
  739.       MailChek will first begin by compiling the setup in MAILCHEK.CNF.
  740.       Once  that's  completed  it will  begin compiling the user index.
  741.       After it has finished that task it will begin to compile the info
  742.       from the message areas  you have  specified in  the control file.
  743.       The  time it  takes to  do this depends on the number  of message
  744.       areas and the number of messages on your particular system.  Upon
  745.       completion of these three tasks,  MAILCHEK  will  create two  new
  746.       files;  MAILCHEK.CTL and  USERBASE.CTL. USERBASE.CTL contains the 
  747.       names  and information of everyone that has mail  waiting.   This 
  748.       is  the file that MAILS1-3.EXE looks at to see if a user has mail
  749.       waiting and where it is.   You have no need to  do anything  with  
  750.       these two .CTL files.   They are updated or created as needed  by 
  751.       the MailChek program itself.
  752.  
  753.       Once MAILCHEK COMPILE has been completed, fire up  OPUS, sit back
  754.       and wait for your first caller.   After the  user enters his name
  755.       and  password,  WELCOME.BBS/GBS is  displayed.  From  within  the
  756.       welcome file, MAILCHEK.DAT is created and the users  name is  put
  757.       in it  with the  embedded commands of OPUS.  A dummy file is then
  758.       opened to force OPUS to close MAILCHEK.DAT.  MAILS1-3 is executed
  759.       by the line '^OCmails1-3'.  You will see this executed at the dos
  760.       prompt, but your user does.  MAILS1-3 finds  the users  name from
  761.       MAILCHEK.DAT and looks through USERBASE.CTL for any mail for this
  762.       particular  user,  and  whether  it  finds  any or  not,  creates
  763.       MAILCHEK.BBS/GBS.  MAILCHEK.BBS/GBS will contain  a list of areas
  764.       and messages that are waiting for the user, or if the user has no
  765.       mail, "Sorry, you have no mail today"  or your own custom message
  766.       depending on how you have it  set up.  After  MAILS1-3  scans for
  767.       mail and creates this file, it's displayed  to the user  with the
  768.       line  in the  WELCOME.BBS/GBS file that says '^OSmailchek'. After
  769.       MAILCHEK.BBS/GBS  is displayed,  the file  you specified with the
  770.       LINK command  in the  control file  is displayed.  If no file has
  771.       been  specified, OPUS  will take over at this point.  If you have
  772.       bulletins, those  will be  displayed, otherwise  the user will go
  773.       directly to the OPUS main menu.
  774.  
  775.       The next  step of MAILCHEK  takes over  when the  user logs  off.
  776.       When the user has logged off, OPUS will drop into your batch file
  777.       with the errorlevel you have set in the OPUS.CTL file.  The batch
  778.       file  should then  execute MAILCHEK UPDATE  and  when  completed,
  779.       return to run OPUS.  I won't attempt to go into detail  on how to
  780.       create  a batch  file, or  explain how  errorlevels  work.  Since
  781.       you're running a bbs, odds are good that you don't need any  type
  782.       of instruction.  If you  do need help, drag  out your DOS  manual
  783.       and read up on batch files, or  look at  the  sample  RUNOPUS.BAT
  784.       file included in the MAILCHEK.ARC file.
  785.  
  786.  
  787.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  788.  
  789.  
  790.  
  791.  
  792.  
  793.                                                                 Page 12
  794.  
  795.  
  796.  
  797.       MAILCHEK UPDATE will perform the following functions after a user
  798.       has logged off. First, if it was a first time caller, Update will
  799.       begin by recompiling the user index.  This step is only performed
  800.       for first time callers.  Next, Update will go through the message
  801.       areas you have  included in  the control file and will update  or
  802.       recompile each area that has had some message activity with  this
  803.       user.   Most areas will merely be updated, some may be recompiled
  804.       if messages  are deleted,  or if MailChek  has  found any  of the
  805.       message pointers  corrupt.  This updating  is VERY  fast and  not
  806.       anywhere near  the time  it takes  to compile with the first run.
  807.       Your system should be ready for the next caller within 30 seconds
  808.       of the last callers log off. Most of the time it will be ready in
  809.       less than 15 seconds.
  810.  
  811.       After Updating is completed, OPUS is restarted through your batch
  812.       file.  Since all the MailChek data files  are updated  after each
  813.       caller, the mail waiting list is  always up to  the minute.  Your
  814.       new users will never again leave you the same questions  over and
  815.       over while never bothering to see if there has been a reply!
  816.  
  817.  
  818.  
  819.                          NOTES, PROBLEMS, OPINIONS
  820.  
  821.       I don't run a SEAdog front end.  I run a pure OPUS system and use
  822.       FIDO for mail events.  Because OPUS exits immediately upon a user
  823.       or  CRASH mail  disconnect, CRASH  mail is  not handled  properly
  824.       without  some minor  changes.  When I first put MailChek up I had
  825.       other SysOps  say  "Hey, I sent you  crash mail, what happened to
  826.       it?"  It  took a bit  for the  reason to  sink in, but since OPUS
  827.       exits right away to perform the MailChek Update, mail bundles are
  828.       ignored.  You  may want  to include the '-u'  option on  the opus
  829.       command line in your batch file to force opus to unpack mail with
  830.       every  disconnect.  This  is not  the most elegant  way of  doing
  831.       things, and until we see what v1.00 of OPUS is like it's the only
  832.       way to avoid having mail bundles sitting unnoticed on your drive.
  833.       Seems that 95% of you out there run SEAdog and you should have no
  834.       problem in this respect.
  835.  
  836.       First time callers usually don't receive WELCOME.BBS/GBS. This is
  837.       of  little concern  since it is  not likely  they will  have mail
  838.       waiting. Even if someone posted a message to them in anticipation
  839.       of their signing on, MAILCHEK would not have included them in the
  840.       message waiting list since they did not exist in USER.BBS.
  841.  
  842.       If you use ALIAS  to change  all occurances of Sysop to your name,
  843.       AND you  include your  netmail area in the areas checked, MAILCHEK
  844.       will change all mail addressed to  Sysop  (ARCmail and others)  to
  845.       your name.  You may then log on and find MAILCHEK telling you that
  846.       there is LOTS of mail waiting in  your netmail area (especially if
  847.       your lax in getting rid of ARCmail null messages).
  848.  
  849.       Like OPUS, MailChek is  not case  sensitive.   If a  user  posts a
  850.       message to "john doe" it will still notify "John Doe" that  he has
  851.  
  852.  
  853.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  854.  
  855.  
  856.  
  857.  
  858.  
  859.                                                                 Page 13
  860.  
  861.  
  862.       mail waiting.  There is one minor  problem.  OPUS  doesn't  always
  863.       seem to mark the message to "john doe" as received when "John Doe"
  864.       reads it.  Since  MailChek looks for REC'D on a  message, poor 'ol
  865.       John Doe  will be notified that this message is waiting every time
  866.       he logs on if he doesn't kill it right away.
  867.  
  868.  
  869.  
  870.  
  871.  
  872.  
  873.  
  874.  
  875.  
  876.  
  877.  
  878.  
  879.  
  880.  
  881.  
  882.  
  883.  
  884.  
  885.  
  886.  
  887.  
  888.  
  889.  
  890.  
  891.  
  892.  
  893.  
  894.  
  895.  
  896.  
  897.  
  898.  
  899.  
  900.  
  901.  
  902.  
  903.  
  904.  
  905.  
  906.  
  907.  
  908.  
  909.  
  910.  
  911.  
  912.  
  913.  
  914.  
  915.  
  916.  
  917.  
  918.  
  919.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  920.  
  921.  
  922.  
  923.  
  924.  
  925.                                                                 Page 14
  926.  
  927.  
  928.                                     NOTICE
  929.  
  930.  
  931.        *** This  program is ShareWare!!  Only *YOU* can make ShareWare work! ***
  932.  
  933.        If you care about the time and effort  that the  author  has  put
  934.        into this  program  you  are  urged  to  make  a contribution towards
  935.        further development on this project.
  936.  
  937.        Any  user  who  makes  a  contribution of $15  or  more  will  become  a
  938.        registered   user  of  MailChek  and  will  receive  FREE  updates  via
  939.        FidoMail(tm) at each release.
  940.  
  941.  
  942.                                 REGISTRATION FORM
  943.  
  944.  
  945.                Name:___________________             Net/Node:____/_____
  946.  
  947.                Address:________________________________________________
  948.                        ________________________________________________
  949.  
  950.                City State Zipcode: ____________________________________
  951.  
  952.  
  953.                Name of your system:____________________________________
  954.  
  955.  
  956.  Send completed forms to:
  957.                          Marc Ache'
  958.                          9273 Collins Ave.
  959.                          Apt. #1106
  960.                          Surfside      Fl 33154
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.  
  977.  
  978.  
  979.  
  980.  
  981.  
  982.  
  983.  
  984.  
  985.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  986.  
  987.  
  988.  
  989.  
  990.  
  991.                                                                 Page 15
  992.  
  993.  
  994.                                    IN CLOSING
  995.  
  996.  
  997.       If  you  find  a bug in this program or have some idea  to  make  the
  998.       system  better  the  Author is always  open  to  suggestions.  Please
  999.       contact Marc Ache' at any one of the services below or by mail.
  1000.  
  1001.  
  1002.       If  anyone has any comments or requests please leave mail  on any
  1003.       one of  the following services:
  1004.  
  1005.       CompuSci OPUS 135/8 in the Matrix     305-758-4821.
  1006.       or   GEnie MailBox MARC-A
  1007.  
  1008.  
  1009.  
  1010.                          NOTES FROM THE AUTHOR
  1011.  
  1012.       I  would  like to thank all the Beta sites that participated  in  the
  1013.       MailChek  project.  I cannot list all the names,  but I will like  to 
  1014.       thank Mike Janke 135/4 for writing this documentation,  Hal Nevis for 
  1015.       all  the ideas and CHINA BLUE BBS for putting up with me.  Also thank 
  1016.       you to the whole of Net-135 for encouragement and suggestions.
  1017.  
  1018.  
  1019.  
  1020.  
  1021.       NOTICE
  1022.  
  1023.       This  program has been posted in the Public Domain for use by all  OPUS
  1024.       sysops.  Under  no   circumstances   will   this  program  be  sold  or
  1025.       produced   on  a commercial basis.  Feel free to post  this program  on
  1026.       any  board.  If you wish to produce a modified version of this program,
  1027.       please  contact  the author before any such action  is  performed.  The
  1028.       following  program  is  as  is  the author is  not  liable  to  produce
  1029.       upgrades nor is he liable for  any damages caused by the program.  This
  1030.       program is ShareWare!!!. Remember it is your responsability to make the
  1031.       the ShareWare concept work, so please send $15 or more to register your 
  1032.       copy of MailChek, and you will recive free updates.
  1033.  
  1034.  
  1035.  
  1036.  
  1037.  
  1038.  
  1039.  
  1040.  
  1041.  
  1042.  
  1043.  
  1044.  
  1045.  
  1046.  
  1047.  
  1048.  
  1049.  
  1050.  
  1051.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  1052.  
  1053.  
  1054.  
  1055.  
  1056.  
  1057.                                                                 Page 16
  1058.  
  1059.  
  1060.   This is the revision history of MailChek:
  1061.  
  1062.   Version 0.50 : Initial version used only on 135/8.
  1063.  
  1064.   Version 0.60 : Initial Beta release to Miami Opus Boards.
  1065.  
  1066.   Version 0.65 : Special release. Larger stack area allocated. Used only
  1067.                  on 135/4 and 135/8. No more need for RENUM (I thought).
  1068.  
  1069.   Version 0.70 : Need for RENUM eliminated. Addition of the <file>/m option. We
  1070.                  also added in the private and received marks. Update procedure
  1071.                  fixed so it would not fail (Hopefully).
  1072.  
  1073.   Version 0.80 : Major bug found in Update. Certain procedure was not modified 
  1074.                  in the change over from Ver 0.65 to Ver 0.70. (I think we got
  1075.                  it licked now!).   We have also now added in the /r command by 
  1076.                  request.
  1077.  
  1078.   Version 0.82 : Hah! Got it! There was one bug that now and again caused update
  1079.                  not to scan the areas and destroy the Userbase.
  1080.  
  1081.   Version 1.01 : The General Release!! The /r option has been changed from 
  1082.                  include received messages to exclude received messages. /c 
  1083.                  option has been added. 
  1084.  
  1085.   Version 1.02 : Quick upgrade due to bug found by the Sysop of the Trukboard.   
  1086.                  Search command was made case insensitive.           
  1087.  
  1088.   Version 1.50 : Addition of /h, <path>/p and <file>/i options. Also we now 
  1089.                  support message area 0 and all the barricaded message areas.
  1090.                  Internal changes have also been made to the program.
  1091.  
  1092.  Version 2.00  : Complete rewrite of the entire MailChek system.
  1093.  
  1094.  Version 2.05  : Major revision of the Search Module. I think I have fixed
  1095.                  those search module bugs. MAILS1-3.EXE is now 16k smaller.
  1096.  
  1097.  Version 2.06  : Yep! The last version did fix the Search module and in this
  1098.                  version we fixed the problem that caused NetMail not to work
  1099.                  on some systems. The next version of MailChek will probably
  1100.                  be 3.00.
  1101.  
  1102.  
  1103.  
  1104.  
  1105.  
  1106.  
  1107.  
  1108.  
  1109.  
  1110.  
  1111.  
  1112.  
  1113.  
  1114.  
  1115.  
  1116.  
  1117.     MailChek 2.06 Copyright (c) 1987 Marc Ache'. All rights reserved.
  1118.  
  1119.  
  1120.  
  1121.  
  1122.  
  1123.